home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 029a / qfind13.zip / QFIND.DOC < prev    next >
Text File  |  1991-10-05  |  19KB  |  621 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                                         Qfind
  14.  
  15.  
  16.                                 VERSION 1.3 - 9/10/91
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                   Qfind Copyright 1991 by JebSoft and James E. Bell
  23.  
  24.  
  25.                                   135 Gunlock Trace
  26.                                Roswell, Georgia  30076
  27.  
  28.  
  29.                       Electronic Mail on Compuserve: 70270,534
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                              Qfind Version 1.0 - Page 1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.             QFIND (Quick Find) is a set of utility programs that perform
  74.             the function of finding the location of a file or files on
  75.             your system. QFIND uses a different approach than most of
  76.             the file-finding programs avaliable today.
  77.  
  78.               FEATURES:
  79.  
  80.                *  Extremely fast file name search.
  81.  
  82.                *  Very easy to use.
  83.  
  84.                *  Command line version of search program.
  85.  
  86.                *  Microsoft Windows 3.0 version of search program.
  87.  
  88.  
  89.  
  90.  
  91.             Files included in QFND11.ZIP include:
  92.  
  93.  
  94.                QFBUILD.EXE       Builds file for searching from selected
  95.                                  disks.
  96.  
  97.                QFIND.EXE         File finder utility - Command line
  98.                                  version.
  99.  
  100.                QFINDWIN.EXE      File finder utility - Windows version.
  101.  
  102.                THREE_D.DLL       DLL file used in Qfindwin.  This file
  103.                                  should be located in your Windows
  104.                                  directory.
  105.  
  106.                QFIND.DOC         This file
  107.  
  108.                REGISTER.FRM      Registration form.
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.                              Qfind Version 1.0 - Page 2
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.             Qfind, like many DOS utilities, was born of necessity.  I
  136.             needed to find "that file".  I did not know which directory
  137.             contained the file, much less which disk contained the file.
  138.             I got out one of the existing file find utilitles and used
  139.             it to search all my drives for "that file".  After much disk
  140.             activity, I found the file.  I needed to find another file
  141.             later and did the same thing. Most of my files (99%) had not
  142.             changed their location on my system between searches.  Why
  143.             do all that disk activity each time I need to find a file
  144.             when most of the files are still in the same location since
  145.             the last time?  Why not "remember" where all the files are
  146.             located and use that data for later searches.  If the file
  147.             system has changed considerably since the last search, just
  148.             build the file database again and use the new one to search.
  149.  
  150.             Qfind is a file finding system that does just that.  Qfbuild
  151.             builds a data file that contains all files on all selected
  152.             drives on your system. The search programs (Qfind and
  153.             Qfindwin) then use that file to do their searches.  This
  154.             results in extremely fast search times since the actual file
  155.             names in the disk directories are not read again.  On one of
  156.             my machines that has 6 32 meg logical drives and 5000+
  157.             files, the search time is less than 3 seconds.  On another
  158.             machines that has 2 32 meg logical drives, 8 network drives
  159.             and over 15,000 files, the search time is less than 5
  160.             seconds.
  161.  
  162.             ************************************************************
  163.  
  164.             QFBUILD.EXE
  165.  
  166.             Qfbuild is the program that builds the database that
  167.             contains all the file names and directory names on selected
  168.             drives along with the optional switches for including Arc
  169.             and Zip files. .  It is executed from the command line with
  170.             the following syntax....
  171.  
  172.                QFBUILD [-z] [-a] first_drive next_drive next_drive
  173.                etc....
  174.  
  175.             The Arc and Zip switches must precede the drive letters.
  176.             The "[ ]" are not not included on the actual command line.
  177.             They are here to show that these parameters are optional.
  178.             If the -z switch is included, all ZIP files on the selected
  179.             drives will be searched to include their files names in
  180.             Qfind.dat.  The -a switch is for ARC files.
  181.  
  182.                Examples:
  183.  
  184.                QFBUILD  -a c d e f g
  185.  
  186.  
  187.                              Qfind Version 1.0 - Page 3
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                This would build a Qfind.dat containing all files in
  195.                drives c, d, e, f, g and the internal directories of any
  196.                ARC files found on these drives.
  197.  
  198.                QFBUILD  -z  e f g
  199.                This would build a Qfind.dat containing all files in
  200.                drives e, f, g and the internal directories of any  ZIP
  201.                files found on these drives.
  202.  
  203.                QFBUILD  -a -z c: d: e: f: g:
  204.                This would build a Qfind.dat containing all files in
  205.                drives c, d, e, f, g and the internal directories of any
  206.                ARC and ZIP files found on these drives.
  207.  
  208.             Qfbuild will take drive letters with or without the trailing
  209.             ":"  after the drive letter.  The data file is built in the
  210.             order of the drives on the command line.  If you need to
  211.             alter the order for some reason, just order the drives on
  212.             the command line as you wish.
  213.             Qfbuild sorts the file names in each subdirectory in
  214.             ascending order.  This was done to make it easier to
  215.             visually read the ouput in Qfind or Qfindwin.
  216.  
  217.             The inclusion of the -z and -a switch is recommended.
  218.             Qfind.dat would then contain all files on the selected disks
  219.             including the files contained in the ARC and ZIP files.
  220.             The only reason for leaving out the -z and -a switch on the
  221.             command line would be to make Qfind.dat smaller.  Qfind and
  222.             QfindWin both have the ability to search for files either
  223.             including or excluding ARC and ZIP files.
  224.  
  225.             Changing the location of the data file....
  226.  
  227.                Normally, the data file is written to the root directory
  228.                of the C drive.  If you need to change the location, add
  229.                the variable QFIND to the environment. The variable QFIND
  230.                is set to the drive and directory where you want the data
  231.                file to be located.  Example....
  232.  
  233.                     Set QFIND=E:\QFIND
  234.  
  235.                QFBUILD will write the data file in the QFIND directory
  236.                on the E drive and QFIND will look there to find the
  237.                file.
  238.  
  239.             ***********************************************************
  240.  
  241.             QFIND.EXE
  242.  
  243.             Qfind is the command line version of the search program.  It
  244.             is executed with the very simple syntax as follows....
  245.  
  246.                QFIND [-x] [-g] search_mask
  247.  
  248.  
  249.                              Qfind Version 1.0 - Page 4
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.                Example:
  257.  
  258.                Qfind *.c
  259.  
  260.             The above command will find all the .C files on all selected
  261.             drives and list them to the screen.  I did not allow for
  262.             multiple search masks because the search is so fast and the
  263.             actual directory structure is not re-read for each search.
  264.             If you need to find files with another search mask, just re-
  265.             execute Qfind with the new search mask.
  266.  
  267.             The -x switch must precede the search mask parameter, and is
  268.             used to exclude the search of the contents of any ARC or ZIP
  269.             files.  If the -x switch is added to the command line, Qfind
  270.             will NOT search the contents of ARC or ZIP files.
  271.  
  272.             If QFBUILD was not created with the contents of ARC or ZIP
  273.             files selected, then Qfind cannot access the names in those
  274.             files.  Therefore the -x switch would have no effect.
  275.  
  276.             The -g switch is added to provide a "GOTO" function to
  277.             Qfind.  If the -g switch is selected, it will change the
  278.             current drive and the current directory to the drive and
  279.             directory containing the matched file name.
  280.  
  281.                Example:
  282.  
  283.                QFind -g xyz.exe
  284.  
  285.  
  286.             The current drive and current directory will be changed to
  287.             the drive and directory that contains the FIRST occurrence
  288.             of XYZ.EXE.  If there are multiple copies of XYZ.EXE on your
  289.             system QFind selects the first one matched in the data file
  290.             built by QFBUILD.  In this example, Qfind would also search
  291.             the contents of any ZIP or ARC files since the -x parameter
  292.             is omitted.  If a file match were found in a ZIP file, Qfind
  293.             would change the drive and directory to the drive and
  294.             directory containing the ZIP file.  If you don't want to
  295.             match names in the ZIP or ARC files, just place the -x
  296.             switch along with the -g switch on the command line like
  297.             so....
  298.  
  299.                Qfind -x -g xyz.exe
  300.  
  301.  
  302.             The search mask conforms to the standard DOS wildcard naming
  303.             convention.
  304.  
  305.               Examples:
  306.  
  307.              QFIND ???e???.*  Will find all files with an "E" in the
  308.                               4th character of the file name.
  309.  
  310.  
  311.                              Qfind Version 1.0 - Page 5
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.              QFIND *.?X?      Will find all files with an "X" in the
  319.                               2nd character of the file type.
  320.  
  321.              QFIND ?abc*.exe  Will find all .EXE files with "ABC" in
  322.                               the 2nd through the 4th position.
  323.  
  324.  
  325.             QFIND looks for the data file in the root directory of the C
  326.             drive unless the environment variable QFIND is set. See
  327.             QFBUILD for example.
  328.  
  329.  
  330.             ************************************************************
  331.  
  332.             QFINDWIN.EXE
  333.  
  334.             This is the Microsoft Windows 3.0 version of the search
  335.             program.  It uses the same search mask conventions as QFIND.
  336.  
  337.             To use QFINDWIN, execute it from Windows with either the
  338.             program manager or the file manager.  It will display a
  339.             screen with "FIND" on the menu.  Click on FIND and a drop
  340.             down menu will appear.  It has the following items:
  341.  
  342.  
  343.                Find  This selection will display a dialog box asking
  344.                      for the search mask.
  345.  
  346.                About This selection will display the "About" dialog
  347.                      box.
  348.  
  349.                Exit   This selection will exit the program.
  350.  
  351.  
  352.             To search for files......
  353.  
  354.                Click on Find and enter the search mask in the text box.
  355.                click on OK and the matched file names will appear in the
  356.                main box. If there are more matches than will fit in the
  357.                window, vertical scroll bars will appear.  You can use
  358.                these vertical scroll bars to move the text around.
  359.  
  360.             You can use the following scroll bar items.....
  361.  
  362.                Scroll UP (UP arrow) -    Each click will scroll the file
  363.                                          names UP one line.
  364.  
  365.                Scroll DOWN (DOWN arrow)  Each click will scroll the file
  366.                                          names DOWN one line
  367.  
  368.                Scroll Page UP  -         Each click will scroll the file
  369.                                          UP one page.
  370.  
  371.  
  372.  
  373.                              Qfind Version 1.0 - Page 6
  374.  
  375.  
  376.  
  377.  
  378.  
  379.                Scroll Page DOWN -        Each click will scroll the file
  380.                                          DOWN one page.
  381.  
  382.                Move with Thumb -         You can move the display of
  383.                                          file names back and forth with
  384.                                          the thumb control.  The thumb
  385.                                          control is the little square
  386.                                          box in the vertical scroll bar.
  387.                                          If you move the thumb to the
  388.                                          half-way location, the display
  389.                                          of file names will move down to
  390.                                          the middle, etc.
  391.  
  392.             A checkbox for including ARC and ZIP files has been added to
  393.             QFindWin.  Click on the checkbox to toggle the ARC and ZIP
  394.             file setting.  If an "X" appears in the checkbox, QfindWin
  395.             will search for file name matches within ARC and ZIP files.
  396.  
  397.             The QFindWin file name display was updated in this release.
  398.             DIRECTORY names are shown in bold font.  FILE names are
  399.             shown in normal font.  File names that are found within ARC
  400.             or ZIP files are shown in italic type with the ARC or ZIP
  401.             name shown surrounded by "**".
  402.  
  403.             QFINDWIN uses the WIN.INI entry to find the data file
  404.             instead of the environment method.  To tell QFINDWIN where
  405.             the data file is located, place the following 2 lines in the
  406.             WIN.INI file....
  407.  
  408.             [qfind]
  409.                FILE = d:\temp     OR wherever the data file is located.
  410.  
  411.  
  412.             If there is no entry in the WIN.INI file, QFINDWIN will look
  413.             for the data file in the root directory of drive C.
  414.  
  415.             Note........
  416.             THREE_D.DLL must be located in a directory that is defined
  417.             in your path for QFINDWIN to work.  The preferred location
  418.             is in your Windows directory.
  419.  
  420.             ************************************************************
  421.  
  422.             Support....
  423.  
  424.                  I can be reached on Compuserve.  My ID is 70270,534
  425.  
  426.  
  427.             This is Version 1.2 of Qfind.  I would appreciate feedback
  428.             on suggested additional features in the next version,
  429.             problems with this version, etc....
  430.  
  431.  
  432.  
  433.  
  434.  
  435.                              Qfind Version 1.0 - Page 7
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.             Change History:
  443.  
  444.             Version 1.3 was released in October 1991 and the following
  445.             was changed from version 1.2
  446.  
  447.                 Fixed 2 problems with QFBuild.  QFBuild was not
  448.                 cataloging the last sub-directory of each drive.
  449.                 QFBuild was bombing on ZIP files containing long path
  450.                 names.
  451.  
  452.                 Fixed a font size problem with QFindWin.  On some
  453.                 systems, the selected font was too small.
  454.  
  455.             Version 1.2 was released in August 1991 and the following
  456.             was changed from version 1.1....
  457.  
  458.             QFBuild -
  459.                 QFBuild now includes the directory of ARC and ZIP files
  460.             if desired.
  461.  
  462.             Qfind
  463.                 Qfind will now search for file name matches in ARC and
  464.                 ZIP files if desired. A "GoTo" function was added.
  465.  
  466.             QFindWin
  467.                 Qfind will now search for file name matches in ARC and
  468.             ZIP files if desired.
  469.  
  470.             QFGoto is no longer being shipped with the product.  Qfind
  471.             now provides the functionality of QFGoto.
  472.  
  473.             *********************************************
  474.  
  475.             Version 1.1 was released in August 1991 and the following
  476.             was changed from version 1.0....
  477.  
  478.             Qfbuild -
  479.                     No changes
  480.  
  481.             Qfind -
  482.                     No changes
  483.  
  484.             Qfgoto -
  485.                     No changes
  486.  
  487.             QfindWin -
  488.                 Fixed a font problem with Super VGA.  The original font
  489.                was too small for super VGA.  The program now detects
  490.                super VGA and uses a larger font.
  491.  
  492.                Added a match count to the main window title.
  493.  
  494.                Added 3D look in all the dialog boxes.
  495.  
  496.  
  497.                              Qfind Version 1.0 - Page 8
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.                    The 3D look uses THREE_D.DLL which was provided by:
  505.                         Ray Donahue
  506.                         365 Mather Street Unit 125
  507.                         Hamden, CT 06514
  508.  
  509.             *********************************************
  510.  
  511.             Version 1.0 was released in July 1991.
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.                              Qfind Version 1.0 - Page 9
  560.  
  561.  
  562.  
  563.  
  564.  
  565.             Registration
  566.  
  567.             Registering QFIND will get you the latest version of the
  568.             programs along with a utility that will personalize your
  569.             copy and remove the start-up message in QFINDWIN.
  570.  
  571.  
  572.             Disclaimer:
  573.  
  574.             Users of QFIND, QFINDWIN, and QFBUILD must accept this
  575.             disclaimer of warranty: "QFIND, QFINDWIN, and QFBUILD are
  576.             supplied as is.  The author disclaims all warranties,
  577.             expressed or implied, including, without limitation,the
  578.             warranties of merchantability and of fitness for any
  579.             purpose.  The author assumes no liability for damages,
  580.             direct or consequential, which may result from the use of
  581.             these programs."
  582.  
  583.             LICENSING AGREEMENT:
  584.  
  585.             QFIND, QFINDWIN,  AND QFBUILD are Copyright 1991 by JebSoft
  586.             and James E. Bell 135 Gunlock Trace, Roswell, Georgia  30076
  587.  
  588.             This program is made available through Shareware for
  589.             personal use on non-business PC's only.  If you find these
  590.             programs useful and find that you are using them and
  591.             continue to use them after a reasonable trial period, you
  592.             must make a registration payment of $10.00 to James E. Bell.
  593.  
  594.             Use of this program by any business, corporation, government
  595.             agency, or any other institution is prohibited without
  596.             payment of $10.00 to James E. Bell for each installed PC.
  597.  
  598.             In accordance with the Shareware distribution method, all
  599.             users are granted a limited license to copy QFIND, QFINDWIN,
  600.             and QFBUILD for the trial use of others providing that there
  601.             programs are:
  602.  
  603.                  Copied in their original archive form.
  604.  
  605.                  Not modified in any way and are distributed with the
  606.                  full and unmodified documentation.
  607.  
  608.                  Are not sold or traded for money or any other
  609.                  consideration by any party other than JebSoft and James
  610.                  E. Bell
  611.  
  612.                  Not distributed in conjunction with any other product
  613.                  or software without the written consent of James E.
  614.                  Bell.
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.                              Qfind Version 1.0 - Page 10